home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / progtool / alle / ramsch / rcs.txt < prev    next >
Encoding:
Text File  |  1994-09-22  |  10.3 KB  |  201 lines
  1. **************************************************************************
  2.  
  3. *                                                                        *
  4.  
  5. *                          RAMSCH-RCS 1.0                                *
  6.  
  7. *                                                                        *
  8.  
  9. *                       by Rainer M. Schmid                              *
  10.  
  11. *                                                                        *
  12.  
  13. **************************************************************************
  14.  
  15.  
  16.  
  17. 0. Allgemeines
  18.  
  19. Dies ist ein fantastisches, unglaubliches, noch nie dagewesenes 
  20. Resource-Construction-Set von einem unglaublichen Programmierer entworfen 
  21. und geschrieben: MIR
  22.  
  23. Noch unglaublicher und fantastischer ist, daß dieses Programm Public 
  24. Domain ist und nix kostest und jeder es frei kopieren kann. (Dennoch will 
  25. ich niemanden abhalten, mir eine kleine Spende zu spendieren).
  26.  
  27. Es sollte in der mittleren und hohen Auflösung ohne Schwierigkeiten laufen 
  28. (bei der niedrigen Auflösung gibt es Probleme, da die Dialogfelder zu groß 
  29. sind). Sollten wider Erwarten dennoch Fehler auftreten schreiben Sie mir 
  30. bitte möglichst genau, wie, wann, unter welchen Umständen etc. der Fehler 
  31. aufgetreten ist, so daß ich ihn zu Hause wiederholen kann (siehe auch 
  32. Abschnitt Bugs).
  33.  
  34.  
  35.  
  36. 1. Bedienung
  37.  
  38. Da viele Funktionen des Programms selbterklärend sind, möchte ich nur auf 
  39. Besonderheiten der Bedienung eingehen.
  40.  
  41.  
  42.  
  43. 1.1. Hinzufügen eines Trees
  44.  
  45. Links neben dem Window ist ein Dialog zu sehen. Die Icons können ins 
  46. Fenster gedraggt werden, um einen neuen Tree zu erzeugen. Die einzelnen 
  47. Icons haben dabei folgende Bedeutung: 
  48.  
  49.         MENUE:          Ein Pulldown-Menue wird im Speicher erzeugt.
  50.  
  51.         DIALOG:         Ein normales Dialogfeld wird erzeugt (dabei 
  52.                         wird für die Objekte ein Raster benutzt).
  53.  
  54.         FREE:           Wie DIALOG, allerdings ohne Raster
  55.  
  56.         UNBEKANNT:      Wie FREE, sollte man aus Übersichtlichkeit 
  57.                         nicht verwenden; dient hauptsächlich dazu, 
  58.                         wenn ein fremdes Resource geladen wird, das 
  59.                         keine DEF-Datei besitzt, zu signalisieren, 
  60.                         daß der Typ nicht erkannt werden konnte.
  61.  
  62. Mit einem Doppelclick auf das jeweilige Icon im Fenster, kann es zur 
  63. Bearbeitung geöffnet werden. Dabei ändert sich auch der Inhalt des 
  64. Dialogs, das jetzt die Objekte enthält, die man dem Tree hinzufügen kann. 
  65. Das Hinzufügen erfolgt durch ein einfaches Draggen des Objekts an die 
  66. Stelle, an der es Erscheinen soll.
  67.  
  68. Die Verkettung wird so vorgenommen, daß das neue Objekt Sohn des Objekts 
  69. ist, innerhalb dessen sich die linke obere Ecke des neuen Objekts sich 
  70. befindet. Objekte können verschoben werden, indem man sie an die neue 
  71. Position draggt. Dabei ändert bzw. kann sich die Verkettung ändern, wenn 
  72. die linke obere Ecke des verschobenen Objekts sich in einem anderen Objekt 
  73. befindet. (Dies alles gilt nicht für Menues.)
  74.  
  75. Betätigt man den Closer des Fensters (in dem "Tree-Bearbeitungs-Modus"), 
  76. gelant man in den "Tree-hinzufügen-Modus" zurück.
  77.  
  78.  
  79.  
  80. 1.2. Menue "RSC überladen"
  81.  
  82. Entspricht dem normalen Laden, allerdings wird man nicht aufgefordert, ein 
  83. File auszuwählen, sondern das bereits geladene Resource (Pfad und Name 
  84. stehen in der Titelzeile des Fensters) wird geladen. Dabei gehen 
  85. selbstverständlich alle bisher gemachten Änderungen verloren.
  86.  
  87.  
  88.  
  89. 1.3. Menue "RSC anhängen"
  90.  
  91. Tip: Sollten Sie Probleme mit einem Resource-File haben (d.h. es wird 
  92. nicht korrekt geladen), dann sollten Sie es mal mit dieser Funktion 
  93. versuchen zu laden. (Vorher aber noch ein im Speicher befindliches 
  94. Resource mit "Neu" löschen.)
  95.  
  96.  
  97.  
  98. 1.4. Icon-Editor
  99.  
  100. Das unterstützte Icon-Format entspricht dem von IconEdi (von Stefan Münch) 
  101. benutzten. Dieses Programm ist als Public-Domain erhältlich und jedem, der 
  102. öfters mit Icons arbeitet zu empfehlen. Da ich darauf verzichtet habe, 
  103. einen Icon-Editor zu implementieren, kann man einen externen Icon-Editor 
  104. aufrufen (dessen Pfad und Name muß erst mit dem Menue-Punkt "Icon-Eitor 
  105. lokalisieren" festgelegt werden).
  106.  
  107.  
  108.  
  109. 1.5. Klemmbrett
  110.  
  111. Das Klemmbrett ist ein Speicher, in dem man einzelne Objekte (mit Kindern) 
  112. und auch ganze Trees zwischenspeichern kann, um diese später wieder 
  113. herunterzuholen. Dabei kann jeweils nur ein Objekt (d.h. Objekt, evtl. mit 
  114. Kindern oder Tree) sich auf dem Klemmbrett befinden. Befand sich vorher 
  115. schon eines darauf, so geht es verloren.
  116.  
  117. "Ins Klemmbrett kopieren" kopiert das selektierte Objekt ins Klemmbrett. 
  118. Das ursprüngliche Objekt bleibt erhalten. "Ins Klemmbrett verschieben" 
  119. entspricht der vorherigen Funktion, allerdings wird das ursprüngliche 
  120. Objekt gelöscht.
  121.  
  122. "Von Klemmbrett holen" fügt das sich im Klemmbrett befindliche Objekt an 
  123. der linken oberen Ecke der Root ein. (Bei Trees wird der Tree in die 
  124. Treeliste aufgenommen).
  125.  
  126. "Kopieren" führt gleichzeitig die Funktionen "Ins Klemmbrett kopieren" und 
  127. "Von Klemmbrett holen" aus.
  128.  
  129. Bei MENUEs funktionieren die Klemmbrett-Funktionen nicht.
  130.  
  131.  
  132.  
  133. 1.6. Menue "Raster einstellen"
  134.  
  135. Beim Typ DIALOG wird ein Raster benutzt (s.o.). Mit dieser Funktion kann 
  136. man die Rastergröße einstellen.
  137.  
  138.  
  139.  
  140. 1.7. Menue "Bildschirmgröße einstellen"
  141.  
  142. Mit dieser Funktion kann man den maximalen x- und y-Bereich eines Dialogs 
  143. in Pixeln angeben.
  144.  
  145.  
  146.  
  147. 1.8. Menue "Sortieren"
  148.  
  149. Die Kinder der ersten Generation des selektierten Objekts werden sortiert 
  150. (ändert unter anderem auch die Reihenfolge, mit der sie angezeigt werden). 
  151. Hierbei kann man zwischen physischen und logischen Sortieren wählen. Beim 
  152. logischen Sortieren wird nur die Verkettung geändert; die Objektnummern 
  153. bleiben erhalten. Beim physischen Sortieren hingegen werden die Objekte 
  154. direkt vertauscht. D.h. die Objektnummern ändern sich und eine neue 
  155. Compilierung des Programms wird notwendig.
  156.  
  157.  
  158.  
  159. 1.9. Menue "Physisch verauschen mit..."
  160.  
  161. Zuerst selektiert man ein Objekt, das man mit einem anderen physisch 
  162. vertauschen will. Danach wählt man den Menue-Punkt an. Schließlich 
  163. selektiert man noch das Objekt, mit dem es vertauscht werden soll. Dabei 
  164. ändert sich die logische Struktur (Verkettung der Objekte untereinander) 
  165. nicht, sondern nur die Objektnummern.
  166.  
  167. Einen ähnlichen Effekt kann man erzielen, wenn man ein Objekt mit 
  168. Doppelclick öffnet und dann im Eintrag Objekt-Nr diese ändert. (Sofern 
  169. diese Änderung gültig ist wird sie auch ausgeführt. D.h. die 
  170. Objektnummern, und nur die Objektnummern, der beteiligten Objekte werden 
  171. vertauscht.
  172.  
  173.  
  174.  
  175. 1.10. Menue "Unhide"
  176.  
  177. Löscht alle evtl. gesetzten Hide-Flags.
  178.  
  179.  
  180.  
  181. 1.11. Menue "Profi-Modus"
  182.  
  183. Normalerweise können die Flags "indirect" und "lastob" nicht geändert 
  184. werden. Diese Option ermöglicht es jedoch. (Sollte im Normalfall nicht 
  185. benutzt werden, da es bei den meisten Änderungen einen Systemabsturz 
  186. hervorruft; es wurde aber der Vollständigkeit halber hinzugefügt.)
  187.  
  188.  
  189.  
  190. 1.12. Menue "Def-Liste drucken"
  191.  
  192. Hiermit kann man die Namen der einzelnen Objekte ausdrucken. (Um die 
  193. Wrikung der einzelnen Optionen herauszufinden, sollten sie am besten 
  194. ausprobiert werden, falls die Bezeichnung nicht ganz klar ist.)
  195.  
  196.  
  197.  
  198. 1.13. Menue "Icon-Editor lokalisieren"
  199.  
  200. Mit dieser Funktion kann man den Pfad und den Namen des Programms 
  201. festlegen, das bei der Funktion "Icon-Editor aufrufen" aufgerufen werden 
  202. soll.
  203.  
  204.  
  205.  
  206. 1.14. Menue "Status sichern"
  207.  
  208. Diese Funktion speichert die Einstellungen für die Suchpfade (bei 
  209. RSC-Files und bei ICO-Files) und den Pfad und Namen des Icon-Editors. 
  210. Ferner noch die Einstellungen der Funktionen "Bildschirmgröße einstellen" 
  211. und "Raster einstellen". Beim Programmstart werden diese automatisch 
  212. geladen und benutzt. Existiert keine INF-Datei, so werden Default-Werte 
  213. benutzt.
  214.  
  215.  
  216.  
  217. 1.15. Einschränkungen
  218.  
  219. Das Programm unterstützt den Objekttyp "G_IMAGE" nicht.
  220.  
  221. Die Gesamtzahl von Trees ist auf 50 beschränkt.
  222.  
  223.  
  224.  
  225. 2. Bugs
  226.  
  227. "Program testing can be used very effectively to show the presence of 
  228. bugs, but never to show their absenece!" (Dijkstra)
  229.  
  230. Dieses Programm wurde zwar ausführlich getestet, Fehler können aber nicht 
  231. ausgeschlossen werden, daher sollte man öfters eine Sicherheitskopie von 
  232. der Resource-Datei erstellen, um eventuellen Datenverlust zu vermeiden.
  233.  
  234. Ferner bitte ich jeden, der einen Fehler entdeckt, mir dies mitzuteilen, 
  235. und zwar möglichst genau, damit ich ihn reproduzieren kann (möglichst mit 
  236. genauen Angaben des verwendeten Rechners, Betriebsystems, Erweiterungen 
  237. etc.).
  238.  
  239.  
  240.  
  241. 3. In eigener Sache
  242.  
  243. Zuletzt noch ein paar Bemerkungen in eigener Sache:
  244.  
  245. Ich bin gerne bereit, auf Fragen und sonstige Probleme zu antworten, 
  246. allerdings sollte dann ein ausreichend frankierter Briefumschlag beigefügt 
  247. werden; ansonsten kann ich nicht zurückschreiben.
  248.  
  249. Für Vorschläge, Wünsche, Beschwerden und destruktive Kritik bin ich 
  250. dankbar und werde sie gerne in einer neuen Version aufnehmen (falls es 
  251. eine geben wird, denn in einem solchen Programm steckt viel Arbeit und 
  252. Zeit; und ich weiß noch nicht, ob ich noch mehr Arbeit hineinstecken soll 
  253. und ob sich das lohnt).
  254.  
  255. Wenn jemand das erweiterte RSC-Format (d.h. keine Beschränkung der Länge 
  256. des Resource auf 64K) kennt, wäre ich ihm dankbar, wenn er mir dieses 
  257. mitteilen könnte.
  258.  
  259. Auf der Diskette ist noch ein kleines Programm mit dem Namen "TEST.C" 
  260. enthalten. Da ich bei einer neuen Version gerne eine Funktion 
  261. implementieren würde, die es erlaubt ein Resource als C-Quelltext in das 
  262. Pogramm aufzunehmen, wäre es interressant zu erfahren, ob das Programm mit 
  263. Ihrem Compiler zusammenarbeitet bzw. wie es zu modifizieren wäre, damit es 
  264. läuft. (Ein Problem könnte sich vieleicht beim String "str" in der 
  265. Definition vom Objekt "o" ergeben.)
  266.  
  267. In der mir zur Verfügung stehenden Literatur fand ich zwei verschiedene 
  268. Formate für die Iconblk-Struktur (eine mit der Länge von 34 Bytes, die 
  269. andere mit 36 Bytes). Ich habe diejenige mit 34 Bytes implementiert; es 
  270. würde mich aber interessieren, welche die gebräuchliche ist.
  271.  
  272. Außerdem suche ich noch einen guten C-Compiler (z.B: Turbo-C, Pure-C 
  273. etc.), da ich bis jetzt mit dem Public-Domain-Compiler Sozobon-C arbeite, 
  274. und er doch recht langsam ist. Daher an alle, die einen C-Compiler billig 
  275. abzugeben haben: MELDET EUCH!!!
  276.  
  277. Als letztes noch meine Adresse, unter der ihr mich erreichen könnt:
  278.  
  279.  
  280.  
  281. 4. Adresse
  282.  
  283.  
  284.  
  285. Rainer Schmid
  286.  
  287. Am Hagenweg 16
  288.  
  289. 78259 Mühlhausen
  290.  
  291.  
  292.  
  293. Tel: 07733/5521
  294.  
  295.  
  296.  
  297.  
  298.  
  299.